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The information in these notes ha9 been derived largely 
from a disassembly of the DOS code. While every attempt 
has been made to provide correct facts, it is recognized 
that this has not always been achieved. No responsibility 
is taken for any loss or damage that may result from 
the use of the information contained in these notes. 

The reader is advised to verify the facts by experimentation 
before using them where they may cause strife. 

The author wishes to acknowledge the patience of his wife. 
Any reader who is married will know what I mean. 
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1.0.3 There are a number of differences from Single Density DOS, 
apart from the fact that sectors are 256 bytes long, there are 40 
tracks with 32 sectors/track, and groups consist of 8 sectors. 

1.0.4 The directory track is still track 20, but the directory 

begins on sector 5 and extends to sector 32. As before, file names of 
8 characters are all owed,but now a 3 byte extension can be specified 
to denote file types. The directory now contains the number of bytes 
used in the last sector of each file , whereas SD DOS had to work it 
out from the data in the last sector. A maximum of 152 files can be 
defined. The maximum occurs when each file occupies 1 group only. 

1.0.5 Default extensions are : - BAS for BASIC programs,BIN for 
machine code, DAT for anything else. When BASIC opens a file for 
output it uses the extension DAT if none is defined in the command. 

1.0.6 In double density DOS, the D S KI $ command is now an 

instruction and not a function. The form of the instruction is now 
DSKI$<drive>,<trk>,<sect>,<string> 

instead of equating the string to the DSKI$ function. 

1.0.7 The DSKI$,DSK0$ tokens for 32K SD DOS are interchanged 

relative to the DD DOS tokens. It is a good idea to transfer files 

between SD and DD systems via cassette in 'A' format. 

1.0.8 The default device can be changed in the DD DOS by the use 
of the DEVICE command. This sets $ 11B to the device number 
corresponding to the I/O device (02=cassette, $80“drive 0). 

1.0.9 DD DOS now provides for the verification of sector writes to 
the disc. This consists of a read after write to give added confidence 
when storing data. 

1.0.10 Records in DD DOS can now be up to 2048 bytes long and are 
packed into sectors without any wasted space between records. In SD 
DOS, each record is stored in its own sector, even if it is only 1 
byte long, thus wasting the other 127 bytes. 
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1.0 INTRODUCTION 

1.0.1 The following notes outline the organization of the Double 
Density Disc Operating System . The details have been obtained from a 
disassembly of the DOS and in some cases the information may be of 
doubtful validity. Some details have yet to be fully decyphcred, 
particularly in the case of the File Control Block. The author of 
these notes would be grateful of any further information from anyone. 
Some further information may be obtained from "PEACH ROM NOTES" by 
Bruce Rossell and Howard Viccars,THE SOFTWARE HOUSE,Canberra,ACT. 

1.0.2 These notes are not a substitute for the DD DOS manual 
axailable from HITACHI. It is assumed that the reader has read the 
manual but seeks to look deeper into the internal workings of the DOS, 
even if only out of curiosity. 
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1.0.11 Most of the bugs in the SD DOS, identified in "PEACH ROM 
NOTES", seem to have been fixed in DD DOS, and the DOS is now quite 
robust. 
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2.0 STRUCTURE OF THE DOS 

2.0.1 The DOS is loaded by the DD bootstrap program in the ROM at 

address $FE7E - $FEFF. This program actually resides on the disc 

controller card and overlays the bootstrap which is in the BASIC ROM 
at the same address. The overlay disappears if the disc drive is 
switched off. The ROM bootstrap is called by the ROM initialization 
routine (from $FB5E) after the CRTC has been set up. A listing of the 
bootstrap program is included In APPENDIX I. 

2.0.2 The bootstrap loads the DOS loader program from track 

0,sectors 1 and 2 of the disc into address $4400. The DOS loader then 

reads the DOS code from track 1 , starling at sector 1, ending, on 
sector 24. A listing of the DOS loader program is Included in APPENDIX 

I I . 

2.0.3 The DOS loads into address $8800-$9FFF and begins to execute 
when loading is completed. 

2. 1 DOS INITIALIZATION 

2.1.1 The first part of the DOS is once-only initialization code 
which sets up conditions in the low part of RAM (called the 
communication area),to let ROM BASIC know the DOS is there,and to set 
up buffers for disc file transfer. This code ends at address $8AFB and 
is overwritten by BASIC's stack and string area. 

2.1.2 The sequence of events that occurs during DOS initialization 
is as follows: 

a) The area used by the DOS loader program ($44 00-$4 600 ) is 
cleared . 

b) The PF key names are loaded from $FDDB. 

c) Pointers $01CE-$01E0 are given values. 

d) COMO jump table is loaded from $EF39, and buffer space 
allocated . 

e) Pairs of addresses from $FF40 onwards are scanned for 
response,and further COM ports (jump tables and buffers) 
are set up, for a total of 3 additional COMs ports. 

f) LPT0 jump table is loaded from $FE69. No buffer space is 

setup. , 

e) Pairs of addresses from $FF3C onwards are scanned for 
response, and up to two more LPT ports are defined. 

h) The File Allocation Table region start is defined as the 
end of the LPT region. The size of this region depends on 
the number of drives defined in $8AFC by 'CONFIG'. 

i) The FCB addresses are put into the FCB table ( $8B01 - $8B22 ) . 

j) The FIELD buffer address is stored in $8D40. 

k) The start of user RAM can now be defined as the end of the 
FIELD buffer. 

-1) The EXEC and USR(n) jump addresses ($148-$15E) are set to 
'illegal function call'. 

m) The 'syntax error' table is set up from $15E-$lBD, see 
section 2.2. 

n) The TAB table is set up, $01BE-$01C7. 

o) Locations $FF38-$FF3A are scanned for a hardware clock chip 
and the R-C clock flag ($214) is set to $FF if the clock 
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is presen t. 

p) The DOS commands table is loaded from $8A94 to $12A. 

q) The Jumps for the DOS extensions are set up,see section 2.2. 

r) The default device location ($ 1 IB) is set to drive 0. 

s) The code looks at the double byte at $8000. If it ■ $0C07, 
the initialization jumps to $8002, possibly for another type 
of device,or language other than BASIC?? 

t) Ditto for $9800, control branching to $9802. The DD DOS 
initialization does not branch. 

u) The screen is cleared, and the keyboard, light pen and timer 
are enabled. Locations $2B,$3D8 are set to the top of user 
RAM ($ 8AFA ) . 

v) Location $25 and the stack are set to 300 bytes less than 
$ 8A F A, reserving space for strings. 

w) Address $8F83 is set to warm restart vector ($FE), and a 
NEW is perfo rmed. 

x) If the program start address ($ 1D ) is greater than $8600, 
then the message 'not enough memory' is displayed and the 
DOS hangs. 

y) The NEWON flag ($248) is read and a branch to $EC49 is made 
if TERM mode is set. 

z) 0therwise,the DISC BASIC sign-on message is displayed, and 
a Jump to $FD42 is made to display 'bytes free' etc. 

2. 1.3 The sign-on message used by DISC BASIC is stored in $8A9E- 
$8AFB. This message can be changed to suit one's own purpose, 
especially if the DOS has been modified and is a non-standard version. 
The first byte of the message contains the number of bytes in the 


2.1.4 Some suggestions on how to vary the startup procedure will 
be found in section 9. 

2.2 DOS JUMPS IN COMMUNICATIONS AREA 


2.2.1 There are a number of locations in the low part of RAM which 
ROM BASIC refers to during its execution. In a cassette system, these 
locations contain JMP's back to the ROM to continue cassette BASIC 
processing. Refer to "PEACH ROM NOTES" for details. One of the 
functions of the DOS initialization code is to loadthese locations 
with JMP's to the DOS routines which perform the DOS extended 
commands. A list of DD DOS JMP'S follows. 


location 

c ommand 

called from 

JMP to 
(or RTS 

161 

FILES 

E B A 6 

908F 

164 

OPEN 

E 6 8 9 

93 I 2 

167 

CLOSE 

E5FD 

95 77 

1 6A 

OUTPUT to file 

E 82 0 

9 5 1A 

16D 

INPUT from file 

E 804 

94 7 1 

1 70 

POS function 

E 85 7 

9AF8 

1 73 

EOF/LOF 

E8A9 

9 7 0D 

1 76 

INPUT It 

D 0FD 

9A52 

1 79 

'Device unavailable' 

— 

E 6AF 

1 7C 

WHILE-syntax error 

— 

A 80F 

l 7F 

WEND- syntax error 

-- 

A 80F 
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1 82 

COMMAND LINE INPUT 

F4DF 

8F9A 

185 

END OF BASIC STATEMENT 

D 3 B A 

RTS 

188 

DOS BASIC FUNCTIONS 

D 4 4 9 

RTS 

18B 

MON 

DC E 6 

RTS 

18E 

ERROR MESSACES 

A 3 A 9 

RTS 

1 91 

DISC ERROR TRAP 

A J A C 

81) E 9 

1 94 

? ? 

A 7 87 

R T S 

197 

? ? 

D 2 6A 

RTS 

1 9A 

ROM FUNCTION ADDRESS TABLE D39F 

RTS 

19D 

? ? 

D ID 6 

RTS 

1 A0 

ROM FUNCTION HANDLER 

D 3 6 0 

RTS 

1A 3 

INITIALIZING VARIABLES 

A 5 1 6 

RTS 

1A 6 

TERM COMMAND 

EC 4 9 

RTS 

1A 9 

PATCH FROM A739 

A 73 9 

8 F 6 2 

1A C 

STRING HANDLING 

DE 50 

RTS 

1A F 

CTRL/C, CTRL/D 

E D 94 

RTS 

1B 2 

CTRL /S 

F 8 1 4 

RTS 

IB 5 

TYPE CHECKING 

AAA 2 

RTS 

IB 8 

STRING HANDLING 

AD 9 8 

RTS 

IBB 

FILE NAME HANDLING 

E 4 0 5 

9789 

2.3 DOS MAP 




ADDRESS 

FUNCTION 



8800-8AFB 

Initialization code 



8AFC-8B35 

DOS variables 



8B36-8C35 

Primary DOS buffer (256 bytes) 


8C36-8D35 

Secondary DOS buffer (256 

bytes) 


8D3 6-8D4B 

More DOS variables 



8D4C-8D82 

DOS instruction mnemonics- 




DSKINI,DSKI$,DSKO $,KILL,NAME,FIELD,LSET 



RSET,PUT,GET,VERIFY,DEVICE 



8D 83 -8D 9A 

DOS instruction address table 



The order of the addresses 
mnemo nic order 

corresponds 

to the 

8D9B-8DB6 

DOS functions mnemonics- 
D S KF , C VI , C VS , C VD , MKI $ , MKS $ 

, MKD $,LOC 


8DB 7-8DC 6 

DOS function address table 




The order of t;he addresses 
mnemonic order 

corresponds 

to the 

8DC 7-8DF8 

Code to handle the DOS instructions and 

functions 

8DF9-8F61 

Error handling 



8F62-9F6B 

Code for the DOS instructions and functions 

9F6A-9FF7 

Not used by DOS. The directory DATE mod 

goes here 

9FF8-9FFF 

Pointers to Number of FCB' 

s,read/write 

mode flag 


and the address of the sector read/write routine 

2.4 DOS VARIABLES 



2.4.1 The DOS stores a number of system related values 

in memo ry . 

Some relate to 

the system configuration while the others 

store more 

transient data. 

There are two main variable storage areas, 

one between 

$8AFC - $ 8 B 3 5, 

and the other between $8D36 

- $ 8D 4B. The 

address of 

these va riab1es 

and their deduced meanings are 

listed below 

• 
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8AFC 
8AFD 
8AFE 
8 A F F 
8B00 
8 B 0 1 

8B03-8B22 
8B 23 
8 B 2 4 
8 B 2 5 
8B26 
8 B 2 7 
8 B 2 9 
8B2A 

8B2B-8B2E 
8B 2F 

8B30-8B3 1 
8 B 3 2 
8 B 3 3 

8B34-8B35 


Number of drives - l 

Number of FCB's - 1 

Number of 256-byte field buffers 

Size of field buffer if < 256 

21. meaning unknown 

Points to start of FAT region 

Address of FCB's (max of 16) 

I/O mode : 2 = input , 3**output 
Current drive number 
Current track number 
current sector number 
Current I/O buffer address 
Density flag : 0 = SD , FF =DD 

Disc status register value 
Last track position for each drive 
FF“o f f line 

Sector of (directory where file name found 
-0 if file not found 
Address in buffer of file name 
current FAT value 
Sector of end of directory 

or sector of first deleted entry 
Address in buffer of end of directory 
or address of first deleted entry 


2.4.3 Second variable area 


ADDRESS 


PURPOSE 


8D3 6 
8D3 7 
8D38 
8D39 
8D3A 
8D3C 

8D3D-8D3F 

8D40 

8D4 2 

8D44 

8D46 

8D48 

8D49 

8D4B 


Verify flag : O-OFF , $FF=ON 
Number of tries on error : *5 

Number of FCB's remaining - 1 
Interrupt flag : *0 if no int pending 

Address to vector to after NMI interrupt 
Copy of current DRIVE REGISTER 
File extension 

Start of field buf fer,used for record I/O 
Start of current record in field buffer 
End of field buffer 
FCB address 

0=GET : 5F*PUT ,used for record I/O 
Length of current record 
Density flag 0-SD, FF-DD 


2.5 DOS USEAGE OF COMMUNICATIONS AREA RAM 


2.5.1 As well as the DOS code in $8AFC - $9FF7, and the JMP table 
for the DOS (starting at $109), the DOS also reserves areas 
immediately above the screen memory for Its use. These areas are used 
to hold the File Allocation Tables (FAT) for each disc drive defined, 
File Control Blocks(FCB) used for file transfer to/from the discs and 
the FIELD buffer used for 'record' I/O. 
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2.5.2 The number of FAT's and FCB's set up at initialization time 
depends on the configuration that has been defined for the disc 
currently in drive 0. The configuration for the disc is specified by 
using the utility program "CONFIG" supplied with the DOS. Because 
tli ese reserved areas occupy valuable RAM space, the user is given the 
opportunity to tailor the DOS on the disc so that only the minimum of 
RAM space is used. 

2.5.3 The number of FAT's required depends on the number of disc 

drives the DOS will be allowed to recognize. The minimum number of 
FAT's required is one, for the DOS disc itself. It is not necessary to 
include drive 1, but file transfer to drive 1 will then cause 'DRIVE 
NOT AVAILABLE' to be displayed. The number of drives - 1 is stored in 

location $8AFC. Each FAT occupies 162 bytes. See Section 3.2 for 
further discussion on FAT's. 

2.5.4 Each open file must have an FCB associated with it, to hold 
data being read from or written to the file. The maximum number of 
files that may be open at any given time is 16. The default number is 
4 but "CONFIG" allows this number to be altered. The number of FCB's - 
1 is stored in $8AFD. Each FCB occupies 281 bytes i.e. a 25 byte 
header and a 256 byte buffer. Section 3.3 discusses FCB's further. 

2.5.5 "CONFIG" also allows the size of the FIELD buffer to be 

defined. It is usual to have a buffer size of 128 or 256 bytes, but up 
to 2048 bytes may be reserved. The address of the start of the FIELD 
buffer is stored in $8D40 and the end in $8D44. $8D42 points to the 

start of the currently referred to record in the FIELD buffer. 

2.5.6 The DOS useage of RAM above the screen memory thus consists 
of the following reserved areas:- 

USER RAM 
FIELD buffer 
FCB n 
FCB n-1 


FCB 1 

FAT Drive number n 

FAT Drive number 1 
FAT Drive number 0 
screen RAM 


I I 
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3.0 DISC FILE SYSTEM 

3.0.1 Files are stored on disc in multiples of groups, where each 
group is 8 sectors . the names of the files and some information about 
the file is stored in a directory. The groups used by each file are 
recorded in a File Allocation Table. When files are accessed, the data 
transferred is buffered in a File Control Block. Record mode files use 
a FIELD buffer to construct records. 

3.1 DISC DIRECTORY 

3.1.1 The disc directory resides on track 20 of each disc, 
starting from sector 5. The directory is initialized by a DSKINI 
instruction, section 7.1. Each directory entry occupies 32 bytes so 
that 8 file names are stored on each sector. The directory extends to 
sector 32 but a maximum of 152 files only is allowed. The directory 
effectively ends at sector 24. 

3.1.2 The end of directory, is indicated by an $FF byte at the 
beginning of the next file name entry. A blank directory contains all 
$FF's. 

3.1.3 When a file name is deleted from the directory, a 00 byte is 
put in the first character position of the file name. When the DOS 
looks for space in the directory to put a new file, it finds either 
the end of directory, or the first deleted file name it comes to. New 
files thus do not always appear at the end of the directory listing. 

3.1.4 The directory listing is displayed by the FILES command. 
This is not a new DOS command but an extension to the cassette system 
command. The code for the FILES command begins at $908F and is called 
from $EBA6 via $161. 

3.1.5 The structure of each directory entry is as follows:- 


0-7 Filename 

8-10 Ex tension 

11 Kind, 0 = BAS, 1 -DAT, 2-BIN 

12 Type, $0-Tokenized BASIC, $FF«ASCII 

13 FAT address of first group of the file 

14 unused 

15 Number of bytes used in last sector 

16-31 unused 

3.1.6 As not all the space in each file name entry in the 
directory is used, it is possible to store there additional 
information about the file. Refer to section 9 for more details. 

3.2 FILE ALLOCATION TABLE (FAT) 


3.2.1 The DOS maintains a table on track 20,sector 2 of each disc 
containing information about where each sector of each file is stored. 
However, rather than keep a complete map of every sector on the 
disc(1280), the storage requirement is reduced by defining the 
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smallest storage segment as 8 sectors. This is called a group.Thus, 
with 40 tracks and 32 sectors per track, the maximum number of groups 
on a disc is 160. The first 16 sectors of track 0 are single density, 
with the DOS boot loader program on sector 1. Although sectors 17-32 
are double density, the whole of track 0 is not available for file 
storage. Track 20 is also not available for file storage as this holds 
the FAT and file directory. If no DOS is on the disc, 152 groups are 
free. However, if a DOS resides on the disc, sectors 1-24 of track 1 
are used to hold the DOS code, reducing the number of groups available 
by 3, to 149. The FAT is set up to handle 152 groups. 

3.2.2 A free or un-allocated group is indicated by an $FF value in 
the FAT. The DOS track is indicated by an $FE value. The directory 
track (20) is not represented in the FAT but is allowed for by adding 
1 to the computed track if it is greater than 19. A FAT value less 
than $C0 indicates the group is part of a file,and points to the next 
group of the file. A FAT value of $C0 - $C8 means that the group is 
the last one in the file. The second digit is the number of sectors 
used in the g roup . 

3.2.3 The current FAT value ( if < $C0 ), points to the address in 
the FAT where the next FAT value may be found. 


3.2.4 The 15th byte of each file name record in the directory 
points to the address in the FAT of the first group of the file. This 
can be decoded into the track and sector number of the first sector of 
the file, as follows. As there are 4 groups on a track, the FAT 
address is divided by 4 to obtain the track number. To protect the 
directory, as already explained, the track number is incremented by 1 
if > = 20. 


3.2.5 The sector number is computed from the remainder after the 
FAT address is divided by 4. This remainder (0-3) determines the group 
number in the track. The remainder is thus multiplied by 8 and then 
incremented by 1 to produce the sector number. 

3.2.6 The FAT for each disc is stored in RAM immediately above the 
screen RAM. Each FAT occupies $9E (158) 1ocations,i.e 152 group values 
plus a 6 byte header. The use of this header is unc1ear , except that 
the first location keeps a count of the number of files open for the 
disc. 

3.2.7 Because the directory is in the middle of the disc (track 
20), it makes sense to store files close by to reduce seek times. The 
DOS therefore allocates groups, starting with track 19, then track 21, 
then 18, then 22 etc, spreading out from track 20. As the utility 
routines are usually the first files to be put on a disc, tracks 18,19 
and 21 are referred to in the DOS manual as the utility tracks. 

3.3 FILE CONTROL BLOCKS (FCB) 


3.3.1 When ever a file is opened for access, an FCB is created. 
This FCB consists of a 25 byte header and a 256 byte buffer. There is 
a limit to how many FCB's may exist at any one time, since they take 
up RAM space which could be used for programs. This limit is set by 
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the utility program "CONFIG" when it asks how many files are allowed 
to be open at any time. 

3.3.2 The addresses of the FCB's are held in a list in the DOS, at 
$ 8B 03 -$8B 2 2. The FCB addresses depend on the screen resolution, since 
the FCB area is above the screen RAM. 


3.3.3 The FCB's are allocated from the last to the first, and 
follows from the fact that the number stored in the open-files table 
is the number of FCB's remaining. 


3.3.A The meanings of the variables stored in the header have not 
all been decyphered, but some are known quite definitely. The meanings 
differ depending on the mode of the data transfer i.e IN PUT,OUT PUT, 
RECORD or DATA modes. 


3.3.5 Relative byte 12 contains a hash value which is derived from 
the sector number of the directory sector containing the file name and 
it's address within the sector, according to the following formula:- 

Hash- (sect-5)*8 + (buffer start-entry address)/3 2 

This hash value is used by the CLOSE command to enter the number of 
bytes used in the last sector into the directory. This method must be 
used since the file name is not kept in the FCB, so the normal 
directory search for the file name entry can not be used. 


3.3.6 INPUT MODE FCB 


OFFSET (hex) MEANING 


00 

Mode, * $ 10 for 

INPUT 

01 

Drive number 


02 

FAT value 

in directory 

03 

Current FAT value 

0A 

Relative 

sector 

in current group 

05 

Numb e r of 

bytes 

read out so far 

06 

unused 



0 7 

Relative 

sector 

of next sector 

08 

unused 



09 

unused 



0A 

unused 



0B 

unused 



0C 

unused 



0D 

unused 



0E 

unused 



OF 

unused 



1 0 

Last char 

flag???? 

1 1 

Last char???? 


1 2 

Directory 

sector/address hash value 

13 

Number of 

bytes 

in last sector 

1 A 

???? 



l 5 

unused 



1 6 

unused 



1 7 

EOF flag, 

- $FF 

if EOF, else - 0 

1 8 

Number of 

chars 

left in buffer 
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Start of data in buffer 


End of buffer 


3.3.7 OUTPUT MODE FCB 


OFFSET(hex) 


Mode, ■ $20 for output 
Drive number 
FAT value in directory 
Current FAT value 

Relative sector in current group 
u n u s e d 

Number of chars put in buffer since last CR 
- chars < $20 are not counted 
Relative sector of next sector 
unused 
unused 
unused 
unused 
unused 
unused 
unused 
un used 
unused 

Terminating char ???? 

Directory sector/address hash value 

Number of bytes in last sector 

unused 

unused 

unused 

unused 

Number of chars in buffer 
Start of data in buffer 


118 End of buffer 


3.3.8 RECORD OR DATA MODE FCB ' 


OFFSET (hex) 

MEANING 

00 

Mode, - $A 0 for RECORD or DATA mode 

0 1 

Drive number 

02 

FAT value in directory 

03 

Current FAT value 

0A 

Relative sector in current group 

05 

unused 

06 

9 ? ? 9 9 

0 7 

Record number for next access 

1 08 


09 

Length of record 

0A 


0B 

Start of record in field buffer 


Hitachi PEACH Double Density DOS Notes By Peter Calder, S. Aust 




1 1 

oc 

; OD ? ? ? ? ? 

! OE unused 

j OF unused 

j 10 Get/Put flag, Get-0, Put-$5F 

' 11 unused 

12 unused 

13 unused 

14 unused 

15 cleared but unused 

16 cleared but unused 

17 cleared but unused 

18 cleared but unused 

19 Start of data in buffer 

118 End of buffer 
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4.0.1 When using the disc for input/output, it is important to 
preserve the integrity of the directory system. This means that any 
writing to the disc should always be done by DOS routines, or at least 
by routines that obey the directory rules. In the discussion that 
follows, this principle will be followed. 


4.0.2 In spite of what has just been said, the DOS supports direct 
reading and writing fro in /to sectors. The user could write programs 
which do not use the directory, but it would be sensible to use discs 
reserved for this direct access method. This type of access would be 
useful for reading or writing discs in a non-PEACH format. 


4.0.3 Disc I/O is an extension of the cassette I/O system 
implemented in the ROM. Each major command such as OPEN, has a JMP to 
a location in the communications area which, in the cassette system, 
either causes a SYNTAX ERROR, or returns to further process the 
cassette command. When the DOS initializes itself, these JMP locations 
are set up to point to the DOS routines which will execute the DOS 
extensions . 


4.0.4 Disc 1/0 can be implemented by directly calling the ROM 
subroutines which perform the OPEN,CL0SE,OUTPUT,IN PUT commands (as is 
detailed in PEACH ROM NOTES). A file name is required for the OPEN 
command, but once the file is opened, it is referred to by its file 
number, stored in $9E. Each open file has a corresponding FCB which is 
located by accessing the OPEN-FILES table by file number. 


4. 1 OPEN FILE COMMAND 

4.1.1 This command is processed by the ROM BASIC code until the 
file description is required. A JMP to $1BB is executed which directs 
the processing to the DOS code at $9789, where the disc drive, file 
name, and extension are extracted from the command. Having obtained 
the file descriptor, the DOS code at $9312 is then executed via $164, 
to open the file. 

4.1.2 The OPEN command has three varients- open for INPUT, open 
for OUTPUT, or open for RECORDS or DATA. The opening process consists 
of setting up a File Control Block for the file, up to the limit of 
the maximum number of open files allowed (see section 2.5.2). The 
OPEN-FILES table is set up, equating the file number with the FCB 
numb er. 

4.1.3 If the file is opened for INPUT, the directory is searched 
for the file name. If found, the first sector of the file is read into 
the FCB buffer ready for subsequent input requests. 

4.1.4 If the file is opened for OUTPUT, the directory is scanned 
for the file name. If found, the file is killed and a new one opened. 

4.1.5 RECORD or DATA mode does not delete a file if it already 
exists. If the file exists and no FCB is already opened, a new FCB is 
opened• 
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4.2 CLOSE FILE COMMAND 

4.2.1 The code for the CLOSE command starts at $9577 and is 
reached via $167 from $E 5FD. If the file to be closed is an INPUT 
file, the closing process involves recovering the used FCB and writing 
out * the FAT. The first location of the FCB header, the I/O mode, is 
set to 0. 

4.2.2 If the file has been used for OUTPUT, the remaining data in 
the FCB buffer is written to the disc and the directory is updated to 
record the number of bytes occupied on the last sector. The FCB space 
is recovered and the FAT written to the disc. 

4.2.3 If in RECORD or DATA mode, the closing process is more 
complicated, as fielded strings have to be moved to the FCB buffer 
before the last record is written. Also, strings that have their 
address pointers pointing to the record area in the FIELD buffer are 
set to NULL strings. The FAT and directory are then updated on disc. 

4.2.4 Files can be closed from a machine code program by setting 
up t he required BASIC command as explained above for OPEN. 
Alternatively, there is a CLOSE-ALL-FILES routine at $E62B which is 
simply called as a subroutine, and is easier to use if all open files 
can be closed at the same time. 
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4.3 INPUT FROM FILE 

4.3.1 This code at $9471 is reached from the generalized input 
routine at $E804 via $ 1 6D . The B register contains the FCB number. A 
character (in the A register) is handed to the calling routine every 
time the input routine is called. 

4.3.2 The FCB is accessed for the next character. If EOF has been 
reached, location $9F is set to $FF. If the FCB buffer has only one 
character left, this character is held while the next sector is read 
in. The held character is returned as the next character. If there is 
more than one character left, the next character is read from the FCB 
buffer and the pointer to the next character is moved on one. 

4.3.3 A typical code sequence for inputting a character from the 
disc is as follows, assuming the file has already been opened for 
INPUT. The character read from the file will be returned in the A 
register. 


CLRB 

TFR 

B , DP 

ONLY IF DP NOT = 0 

LDB 

#$. • • 

FILE NUMBER 

JSR 

$EB 04 

GENERALIZED INPUT ROUTINE 

TST 

$ 9F 

EOF ? 

BNE 

. . . 

YES,PROCESS EOF 

. . . 


NO,PROCESS CHAR 


4.4 OUTPUT TO FILE 

4.4.1 This code is reached from the generalized output routine at 
$E820 via $ 16A. The B register contains the FCB number. A character Is 
accepted in the A register and is entered into the FCB buffer. 

4.4.2 When the FCB is filled by the new character, the buffer is 
written to the disc. The FCB keeps a count of the number of characters 
since the last CR. Control characters ( < space in magnitude) are not 
counted, but they are put into the buffer. 

4.4.3 The DOS variable at $8D36 can be set to $FF if verification 
is desired when writing to the disc. $8D36 is initialized to $FF (on) 
on boot up. Sector writes are slower if verify is on. 

4.4.4 A typical way to output characters to disc, is as follows, 
assuming the file has been opened for OUTPUT. The character to be 
output must be in the A register. 


CLRB 



TFR 

B , DP 

ONLY IF DP NOT - 0 

LDB 

#$. . 

FILE NUMBER 

JSR 

$E 82 0 

GENERALIZED OUTPUT ROUTINE 

TST 

$9F 

GOOD WRITE? 

BNE 


NO,PROCESS BAD WRITE 


GET NEXT CHARACTER 
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4.5 RECORD MODE FILE ACCESS 

4.5.1 The above input and output processes apply to sequential 
files, i.e. ones that have to be read sequentially from beginning to 
end. No information is known about where data is stored in the file, 
so the file must be read sector by sector until the required data is 
found. Data cannot be inserted directly into these files. To add data, 
a new file must be created containing data up to the point where new 
data us to be added, the new data can then be output to the new file, 
then the rest of the old file can be output to the new one. Record 
mode files avoid this problem by allowing reading and writing directly 
to numbered records, no matter where they are in the file. 

4.5.2 For each record mode file created, a fixed length record is 
defined. Each record to be output is constructed in the FIELD buffer 
using the form defined by a FIELD statement in BASIC, and with length 
defined in the OPEN command. 

4.5.3 A number of files may be open for record I/O at any one 
time, but there is only one FIELD buffer. Record structures are kept 
distinct by storing the start of a file's record area, and the record 
length, in the FCB header. The start of the current record is stored 
in $ 8D 4 2, and the length in $8D49. 

4.5.4 The sum of the lengths of all the records currently open 
must be less than the length of the FIELD buffer. For example, 

End of FIELD buffer 


End of record for #2 

End of record for #1,start of record for #2 
Start of FIELD buffer, start of record for #1 

4.5.5 Record lengths do not have to be restricted to multiples of 
powers of 2, but can be any length up to the length of the FIELD 
buffer. The FIELD buffer length is defined by "CONFIG" and may be up 
to 2048 bytes long. This means that records can straddle sector 
b oundar ie s. 

4.5.6 Records are not stored in separate sectors, but are packed 
into the sectors without any wasted space between adjacent records. 
The records themselves may have unused space in them, but record 
boundaries have no gaps between them. 

4.5.7 When accessing a record, the DOS has to calculate the sector 
that the required record is on, and where in the sector the record 
starts. 

4.5.8 If the next record to be output has a record number greater 
than the biggest record number yet written, the DOS fills the sectors 
in between with '£' characters. It is possible to reserve disc space 
for the whole file by PUT-ing to the disc a record with the maximum 
record number which will be used. 
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4.5.9 When a string appears in a FIELD statement, it is placed in 
BASIC's symbol table. The length of the string is taken from the FIELD 
statement, with the address of the string pointing to the position in 
the record in the FIELD buffer where the string will be stored. Until 
an LSET or RSET statement is executed, the strings will have nothing 
in them. Only when an LSET or RSET command is processed will the 
appropiate string contents be moved into the relevent position in the 
record in the FIELD buffer. 


4.5.10 After a record is output with a PUT statement, the symbol 
table is searched for any strings or string array elements that point 
into the record area, and they are set to NULL strings i.e. any string 
that appeared in the appropriate FIELD statement. 


4.5.11 It is apparent that if a file is opened with a record 
structure that is not the same as that used in constructing the file, 
nonsense will result. 


4.5.12 It is possible, however, to have two FIELD statements 
referring to the one record, with the second FIELD statement referring 
to sub-fields of the first record. This is sometimes convenient to 
use, as the following example shows. 


100 FIELD H ,100 AS A$ 

105 GET //1 , RECN0 

110 FIELD //1 , 2 0 AS NAM $,4 0 AS AD$,20 AS NAT$,10 AS SEX $,10 AS TEL $ 
115 PRINT NAM $: PRINT AD $: PRINT NA T $: PRINT SEX$: PRINT T E L $ 


I 
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5.0 FILE STRUCTURES 


5.0.1 When sequential files are stored on the disc under BASIC, 
the first byte of the first sector defines the type of file. A $00 
indicates a binary file, while BASIC files can start with $FF, or $0D. 

5. 1 BINARY FILES 

5.1.1 There are 4 other bytes at the beginning of the binary file, 
and an additional 5 bytes at the end of the file, that are not data 
bytes, but control bytes for the LOADM command's use. 

5.1.2 The second and third bytes contain the count of the number 
of data bytes in the file. This number does not include any of the 10 
control bytes. The fourth and fifth bytes define the first address 
that the file is to be loaded into. 

5.1.3 The 2-byte entry point address of the binary file is stored 
at the end of the data on the last sector, and is preceded by $FF, 
$00, $00. The entry point address is placed in location $148 by the 
LOADM command and is the address jumped to when the R option is used 
with that command. 


5.1.4 The binary file thus has the following structure. 

BYTE SEQUENCE MEANING P,-, ^ 

00 binaryfileindicator v 




binary file indicator v yy*y£, 

2-byte data count * 

2-byte address where the file is loaded 
binary data 


last data byte 

FF entry point header 

00 

0 0 ^ 

XXXX entry point address 

5.2 BASIC FILES 

5.2.1 The first byte of a BASIC file contains either $FF or $0D. 

$FF means that the file is in tokenized form, whereas $0D indicates it 

is in ASCII form. The ASCII form is equivalent to a LIST. 

5.2.2 The next 2 bytes of a tokenized file represent a line 
number, above which BASIC will not display with the LIST command. This 
line number is normally $FFFF, so all lines will be listed. However, 
by use of the UNLIST command before the program is SAVEd, some measure 
of protection can be given from prying eyes. 

5.2.3 A tokenized file is stored with all the address pointers to 

subsequent lines, exactly as the program exists in RAM. However, if it 
is LOADed back into RAM at some future time with a NEWON value that is 

different from that when it was SAVEd, the addresses will be wrong, as 

the program will be loaded into a different part of RAM. BASIC 
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accounts for this and inserts the correct address links for the new 
RAM location. 

5.3 RECORD FILES 


5.3.1 Record files have no control bytes at the start of the file. 
The first record thus begins at byte 0 of the first sector. Subsequent 
records begin at locations that are multiples of the record length 
used to set up the file. Record 2, therefore, would begin in the first 
sector if the record length was less than 256. If the record length 
was greater than 256, the next record would begin in a subsequent 
sector. 


5.3.2 Records that have not had any data output to them, and which 
lie between already defined records, are filled with $40's. Records 
beyond the one with the largest record number so far defined, do not 
exist in the file structure. Space for all the records to be used in 
the file can be reserved by outPUT-ing a record with the largest 
record number to be used, to the file. 
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6.0 DOS SUBROUTINES 

6.0.1 There are a number of DOS subroutines which may be useful to 
the assembly langauge programmer. In the discussion that follows, the 
variables which must be set up before using the routines, and those 
whose values are altered by the routine, are listed. 

6.1 'ARE YOU SURE?' MESSAGE - $904F 

6.1.1 This routine may be useful when requesting confirmation by 

the user of some requested action. The message 'Are you sure (Y or 
N)?' is displayed and the keyboard is read for a reply. If ' Y ' , the 
EQUAL flag is set. If 'N', it is cleared. If any other character is 1 

entered, the message is repeated. 

6.2 COUNT THE NUMBER OF GROUPS IN FILE - $9102 J , 

B reg FAT address of first group of file 

$8B24 Drive number 

A reg The number of groups in the file 

6.2.1 The FILES command uses this routine. The address of the 
appropriate FAT in RAM is found and the FAT scanned from group to 
group until the end group is reached. The X register will point to 
this last group in the FAT, and the B register will have the last 
group value. 

6.2.2 This routine may be useful if the address of the last group 

of a file is wanted, e.g. when determining the entry address of a 
binary file. (This address is saved as the last two bytes of the last v 

sec tor,section 5.1). L 

6.3 COUNT THE NUMBER OF GROUPS LEFT ON DISC - $9102 j 

6.3.1 This routine returns to BASIC after its task is completed. 

However it is a very useful routine so the code is repeated here as a 
subroutine that returns the group count in the B register. 

$8B24 Drive number 

B reg Count returned 

A 

*count 0 groups free on disc 

* r e t u r n result in B reg 

A 

GPSFR JSR $ 9A 02 READ IN FAT FROM DISC j 

JSR $ 9 8C 4 POINT TO FAT (X REG) 

LEAX $06,X POINT PAST HEADER | 

CLR ,-S STORE COUNT ON STACK 

L I) B // $ 9 8 MAX //GROUPS 

G PS 1 L DA , X+ GET fat VALUE 

COMA IS IT $FF ? 

BNE GPS 2 NO,NOT FREE 

INC ,S YES,COUNT IT 
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G PS 2 DECB 

BNE GPS 1 LOOP FOR ALL GROUPS 

PULS B 
RTS 

6.4 FIND FILE NAME IN DIRECTORY - $98D3 

$01FE File name (max 8 chars,padded with spaces) 

$8D3D File extension (max 3 chars,padded with spaces) 

$8B2F Directory sector where file name found 

$8B30 Address in primary buffer where file name found 

$8B32 FAT value of first group of file 

$8B33 sector of end of directory,or first deleted entry 

$8B34 Address in primary buffer of end,or first deleted entry 

6.4.1 The routine reads each directory sector into the primary 

buffer until the file name and extension matches with an entry in the 
directory, or the end of directory is reached. If a match is found, 
$8B2F, $8B30 are updated. If no match is found, $8B2F will be 0. 

6.4.2 The routine also stores the sector and address within the 

primary buffer of the first deleted entry it comes to, or the end of 
the directory. 

6.5 FIND FREE SPACE IN FAT - $9948 

B reg FAT value to start scanning from 

$8B24 Disc drive number 

6.5.1 This routine reads in the FAT from the drive defined in 

$8B24, and scans it for a free space i.e. for an $FF. The scaning 
begins at a point in the FAT defined by the B register. When a free 
space i 8 found the value $C0 is stored in the same location in the FAT 
in RAM. The X register will point to this location on exit. 

6.5.2 If no space is available the error message DISC FULL is 

displayed and control returns to BASIC. 

6.6 READ FAT FROM DISC - $99EF 

$206 Device number 

$8B24 Drive number 

6.6.1 The device number in $206 Is checked for the most 
significant bit set, to Indicate disc I/O. The drive number Is 
extracted from $206 and stored in $8B24. The FAT is then read from the 
appropriate drive and moved into the FAT storage area in RAM. 

6.7 READ/WRITE FROM/TO DISC SECTOR WITH VERIFY - $9D6B 

$ 8 B 2 3 Read/write mode:- read-2, write-3 

$ 8 B 2 4 Drive number 

$8B25 Track number 

$8B26 Sector number 

Hitachi PEACH Double Density DOS Notes By Peter Calder, S. Aust 


I I 

Page 21 



I I I I 1 I I I I I 

6 - DOS SUBROUTINES Page 22 

$8B27 Buffer address to read into or write from 

$ 8B 2 9 DD flag:- DD-$FF, SD-0 

$ 8 0 2A Disc status value f 

$ 8D 3 6 Verify flag:- verify on-$FF, off«$00 

6.7*1 This routine will read or write a sector,according to the 
setting of the above variables. 

6.7.2 If in write mode and verify is on, the routine will read 
back, into the secondary buffer ($8C36-$8D35), the sector just written 
and compare the data read back, with the data held in the input 
buffer. It will re-try five times until no error occurs. A 
VERIFICATION FAILURE will be displayed if still in error, and control 


returns 

t o 

BASIC . 

Writes 

to disc will obviously 

b e 

si ightly 

s1 owe r if 

verify is 

o n 

• 







6.7.3 

If 

the 

status 

variable $8B2A is not 

equal 

to 0 

on return 

from the 


main 

read/write routine($9DE7 ) one 

o f 

the 

error 

messages 


"DRIVE NOT READY", "DISC WRITE PROTECTED",or "DEVICE I/O ERROR" will 
be displayed and control will return to BASIC. 

6.8 MAIN DISC READ/WRITE ROUTINE - $9DE7 

6.8.1 This is the routine that does all the work, according to the 
variables (except verify) already defined in section 6.7. No error 
decoding is made. 

6.8.2 The code expects the disc registers to be $FF00-$FF04. 
Because the DATA BUS is inverted between the CPU and the drives, the 
data sent to or read from the disc registers must be inverted. The 
meaning of these registers is as follows. 


address 

R/W 

MEANING 

$F F 00 

read 

status (see section 6.8.10) 


write 

command to controller 

$ F F 0 1 

read/write 

current t rack 

$F F02 

re ad/write 

required sector 

$ F F 03 

read/write 

data to/from disc 

$ F F 04 

read 

auxilllary status: bit7-NOT(DRQ) 

bit 1 -6-unus ed 
bitO-NOT (IRQ ) 


write 

mode select: bit7“unused 

bit6-NMI mask 


bit 5 =S D/D D DD-l,SD-0 
bit4-SIDE: 0-0,1-1 

bi 1 3-MOTOR ON: on-1 
bit 2-unus ed 
bitO,1-DRIVE SELECT 

6.8.3 The HITACHI disc controller IC is equivalent to the WESTERN 
DIGITAL 1791 floppy disc controller. The commands used by the DOS I/O 
routine are detailed in the following table. 

01 restore, 12 ms stepping rate 

11 s e ek , l 2 ms 
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80 read,single sector,no 15 ms delay 

AO write,single sector,no 15 ms delay 

DO clear,no interrupt 

6.8.4 If the drive is not ready, the routine times out after 
approximately 20 seconds. This gives time to insert a disc if one is 
not already in. 

6.8.5 After the drive is started and up to speed, the code selects 
from an address table, one of four I/O routines to execute. The index 
for this selection is the I/O mode variable $ 8 B 2 3. Note, however, that 
the DOS only ever uses two of these possible four modes, with 2-READ, 
3-WRITE. Mode=0 causes the selected drive to restore the head to track 
0, while mode=l executes an RTS and does no tiling. 

6.8.6 DD disc I/O uses the NMI interrupt for finding the required 
track and sector, as does the SD DOS. However, data transfer to/fro in 
the disc is performed character by character under program control, by 
making use of the DATA REQUEST (DRQ) bit in $FF04. This bit is set by 
the disc controller whenever it needs another character (write), or 
when it has another character available (read). The program simply 
sits in a loop continually examining this bit, and supplying the next 
character, or storing the next character when necessary. 

6.8.7 In SD DOS, the characters are counted and the loop ends when 

128 are transferred. However, in DD DOS, no counting is done. Use is 
made of the fact that the controller will raise an NMI interrupt when 
the end of sector is reached. Hence, before the sector transfer 

begins, the address to vector to when the interrupt is received, is 

set up in $1A9. This address points to the code to execute to check 
that a good transfer has been made. 

6.8.8 This technique has the advantage that the routine can be 
used for reading sectors of any length. The only difference between 
single or double density I/O is bit 5 of $FF04. The controller sorts 
out the disc format. It seems possible to have discs formatted in 
(say) 512 bytes per sector, and have this routine read them. 

6.8.9 The DD DOS disc routine turns off the IRQ and FIRQ 

interrupts while data Is being transferred. This prevents the keyboard 
from interfering with the I/O process, as is the case with the SD DOS. 

6.8.10 Error conditions are returned in $8B2A and have the 

following meaning. 

BIT 
7 
6 
5 
4 
3 
2 
1 
0 
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7.0 NOTES ON DOS COMMANDS 

7.0.1 Apart from extensions to the cassette system < commands, the 
DOS provides additional commands for specific disc actions. These 
commands are referenced from a table of pointers loaded into RAM at 
the end of the BASIC command pointers. As explained in PEACH ROM 
NOTES, the ROM command processing code at $D40D, is set up to look for 
further commands if not found in the first table. The DOS pointer 
table loads into $ 12A from $8A94 during initialization and has the 
following values. 


$1 2A 
$ 1 2 B 
$1 2D 

$0C 
$8D4C 
$ 8D 3 7 

number of disc instructions 
address of instruction names list 
instruction processing routine address 

$ 1 2F 
$130 
$132 

$08 

$8D9B 

$8DDE 

number of disc functions 
address of function names list 
function processing routine address 


7.0.2 The DOS instruction processing routine at $8D37, checks for 
a token value between $DD and $E8. If greater than $E8, the code jumps 
to $137 in case another instruction pointer table exists. For standard 
DOS, $137 points to the 'SYNTAX ERROR'message. 

7.0.3 The function processing routine simply checks for a token 
between $54 and $62. If greater than $62, a jump to $13C is made to 
look for a further table. 

7.0.4 It should be noted that these processing routines only check 
that the token value is legal. The ROM code at $D40D then picks the 
appropriate subroutine address to execute the command, from the 
address list pointed to by the command address table. When tokenizing 
a BASIC statement, the ROM refers directly to the command table. 

7.0.5 The following information on each of the DOS commands may be 
useful in understanding how the command operates. This section does 
not replace the DOS Manual, and assumes the user had read the manual. 

7.0.6 The address listed with each command is the starting address 
in RAM of the command. 

7.1 DSKINI - $ 8FB B 

7.1.1 This code initializes a formatted disc by writing a blank 
directory and FAT on track 20, sectors 1 to 32. All bytes are set to 
$FF. The process takes longer than the SD command, as there are twice 
as many tracks and they contain twice as many bytes. 

7.2 DSKI$ - $ 92 0C 

7.2.1 This INSTRUCTION is a FUNCTION in Single Density DOS. If 
only one string is defined in the BASIC statement, the sector is read 
in single density,i.e. a string of 128 bytes. 


Hitachi PEACH Double Density DOS Notes By Peter Calder, S. Aust 


I I l I I I I I I I 

7 - NOTES ON DOS COMMANDS Page 25 

7.2.2 The required sector is read into the DOS primary 
buffer($8B36-$8C35) and then moved into BASIC's string space. The 
string pointer in BASIC's symbol table is set to point to the string. 
As this operation is directly applied to a specific sector, no FCB is 
involved,i.e it is not necessary to open a file to use this 
instruction. 

7.3 DS KO $ - $92A 6 

7.3.1 The same comments for DSKI$ also apply to DSK0$. The only 
difference is that DSK0$ moves one or two strings from the string 
spac e to disc. 

7.4 KILL - $9119 

7.4.1 This writes a $00 byte in the first character of the file 
name in the directory. The FAT is then searched and ail groups used 
by the file are recovered by setting their FAT value to $FF. 

7.4.2 It is possible to recover the deleted file because the FAT 

value in the directory is not altered by the KILL process. This FAT 
value points to the track and sector of the first sector of the file. 
If the disc has not been altered since the file was KILLED, the 

sectors storing the file will still be intact. By examining the disc 
sector by sector and rewriting the FAT, the file structure can be 

reconstructed. However it is not easy,and one needs a good sector 
read/write program to help. 

7.5 NAME - $91A3 

7.5.1 The name of a file may be changed by altering the file name 

and extension in the directory. Nothing else about the file is 

altered. 

7.6 FIELD - $9B 0 7 


7.6.1 This instruction operates by inserting in BASIC's symbol 
table, strings (whose names are defined in the FIELD command) with 
pointers to the start of each record in the FIELD buffer. Refer to 
Section 4.5 for more discussion. 


7.7 RSET,LSET - $9B45,$9B46 


7.7.1 These commands move the second string defined in the command 
to the first string in the command. The first string named must have a 
pointer within the record in the FIELD buffer that the file is using. 
That is* the string roust have been defined by a FIELD command prior to 
the RSET or LSET command. 


7.7.2 The region that the second string is loaded into is cleared 
before transfer. 


7.7.3 The same code is used for both LSET and RSET, except the 
string when It is moved into the record is left justified in the case 
of the LSET and right justified in the case of RSET. 
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7.8 PUT,GET 


$9B 9F , $9B AO 


7.8.1 The same code is shared by GET and PUT commands. The flag 
$8D48 is used to jump over irrelevant code. $8D48 « 0 for GET and $5F 
for PUT. See Section 4.5 for more discussion on record mode I/O. 

7.8.2 The file must be open for 'record' mode so that an FCB can 
be opened. The current record number is stored in the FCB header* See 
Section 3.3 for a discussion of the FCB structure. 

7.9 VERIFY - $9192 


7.9.1 Verify sets a flag ($8D36) to $FF if writing to the disc is 
to be verified, and to $00 if no verification is required. Refer to 
Section 6.7 for a discussion of the verification process. 

7.10 DEVICE - $917B 

7.10.1 The DEVICE command allows the default I/O device to be 
redefined. The default device set up at boot time is drive 0. Location 
$11B contains this device number ( $02-casse11e, $80*drive 0 ). This 
command is useful if a lot of use is to be made of (say) the cassette. 

7.11 DSKF function - $96B6 

7.11.1 This computes the number of free groups on the disc. The 
FAT is scanned and the integer result is returned to BASIC by a JMP 
to $AC E 6. The result is placed in $58, $59 by $ACE6. 

7.12 CVI,CVS,CVD functions - $9D34,$9D37,$9D3A 

7.12.1 These three functions share similar code. They set the B 
register to 2,4 or 8 respv then JSR to $AEB 7 which does the 
conversion. 

7.13 MKI$,MKS$,MKD$ functions - $9D4E,$9D51,$9D54 

7.13.1 These three functions also share similar code. They set the 
B register to 2,4, or 8 respv then JSR to $AD78 which converts the 
numbers to character strings of 2,4, or 8 bytes. 

7. 14 LOC - $96DE 


7. 14. 1 This code gets the next record number of an open file from 
its FCB and returns to BASIC with a JMP to $ACE7 which stores the D 
register in $58, $59. 

7.15 LOF/EOF - $970D 


7.15.1 This code is reached from $E8A9 via $173. If EOF is 
requested, the FCB is first checked for input mode, then relative byte 
$10 of the FCB is examined. If - 0, there are still some bytes in the 
buffer, and the number remaining,(held in relative byte $17) is 
returned to BASIC. If not ■ 0, the buffer is empty, and $FF is 
returned to BASIC as EOF. 
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8.0 DD DISC FORMAT 

8.0.1 The floppy disc controller used in the PEACH* is equivalent 
to the WESTERN DIGITAL 1791 IC which can support a number of different 
DD formats, as well as SD. 

8.0.2 The disc is formatted in terms of concentric tracks made up 
of a number of sectors. Data can be read from or written to the disc 
only in whole sectors. 

8.0.3 The HITACHI DD format consists of 40 tracks (numbered 0 to 

39) on each side. There are 16 sectors (numbered 1 to 16) in each 

track on EACH side. The DD DOS considers tracks to have a total of 32 
sectors, with sectors 1 to 16 on side 0, and sectors 17 to 32 on side 

1 . 

8.0.4 Each sector has a header defining the track number, side 
number, sector number, and number of data bytes. 

8.0.5 Sectors are separated by gaps containing control bytes 
designed to enable the controller to synchronize to the pattern. This 
is necessary because if the disc speed varies, the physical length of 
the data bytes will be slightly longer or shorter every time they are 
re-written. Thus there may be some left-over bits at the end of the 
data area in each sector. The controller therefore must resynchronize 
after reading every sector. 

8.0.6 The number of data bytes in the sector is flagged in the 

sector header. This flag can have 4 values as the following table 

shows. The DD sectors use a value of 01, with SD sectors using 00. 

Sector flag Number of bytes 

in sector 

00 128 

01 256 

02 51 2 

03 1024 

8.0.7 The sectors are not stored in consecutive order on a track. 

The order for the DD discs is 1,9,4,12,7,15,2,10,5,13,8,16,3,11,6,14. 
This may seem strange, but it will be noticed that there are 5 sectors 
between consecutively numbered sectors. This gives time fora program 
to process one sector before the next one comes under the head. You 
will have noticed that FORMAT uses a machine code program called 
SKIP5. No marks for guessing the origin of the name! 

8.0.8 The disc rotates at approximately 300 rpm. One revolution 
therefore takes 3.33 ms. One sector is under the head for 0.208 ms. 5 
sectors are scanned in 1.04 ms. This then is the maximum time a 
program can spend processing a sector if it is to ready for the next 
sector before it passes the head. 

8.0.9 Discs are formatted by writing whole tracks in one go. The 
track data is set up in memory in one long buffer and written onto the 
disc by issueing a TRACK WRITE command to the disc controller. 
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( 12 

00 

) 



( 3 

F 5 

) 



( 1 

FB data mark 

>- 

s ectc/r 

DATA 

( 2 56 
( 1 

<data bytes> 

F 7 2 CRC ' s written 

) 

) 



( 55 

4E separator 

) 



598 

4E separator 

)- 

END OF 

TRACK 


8.0.13 Note that when the controller receives an $F7 byte it 
automatically generates a 2-byte CRC (Cyclic Redundancy Checksum). 
This CRC is recalculated by the controller when the sector is read and 
the CRC error bit in the status byte set accordingly. The disc 
routines do not have to concern themselves with this CRC generation, 
only if it is correct or otherwise. 

8.0.14 The WRITE TRACK command writes data continually from the 
index hole on the disc to the next time the index hole is reached. The 
number of bytes specified as the end of track separators are only 
approximate. More than this amount should be provided for so that the 
index hole is always reached. 
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9.0 DOS WEAKNESSES AND IMPROVEMENTS 

9.0.1 There are a number of areas where the DOS is lacking. While 
the DOS seems to be well written and bug free, a number of 
improvements could be made to increase the utility of the DOS, and 
make it more versatile. 

9.0.2 There is some unused space at the end of the DOS, from 
$9F6A-$9FF7, which can be used to hold some code. This has already 
been used to good effect by some of the improvements to be discussed. 
However, this space is very limited, and other techniques will also be 
discussed for storing new code elsewhere. 

9. 1 NUMBER OF SECTORS PER GROUP 

9.1.1 The smallest number of sectors that can be allocated to a 
file is one group, or 8 sectors. This is very wasteful, as few 
programs occupy more than two groups. The SD DOS allocates groups of 4 
sectors at a time, with each sector containing half the number of 
bytes as DD sectors. This is not as profligate as DD DOS, but still 
wastes space in the last group. One of the reasons for the group size 
is to reduce the size of the FAT. The FAT's of each disc have space 
reserved for them in RAM, and the bigger the FAT, the less user space 
there is available. The SD FAT size is 160 bytes, while 158 bytes are 
required for the DD DOS. If sectors were allocated individually, the 
DD FAT would need to be 1286 bytes long. It is probably because of 
this fact that we are stuck with groups of 8 sectors each. 

9.1.2 There is room on the disc for an FAT to be 4 sectors long, 
even if the directory start remains at sector 5. This could easily be 
moved to make room for a larger FAT. However, the benefits to be 
gained by enlarging the FAT must be weighed against the fact that user 
RAM would be significantly reduced, and would result in a DOS that 
would be incompatable with the standard DOS. 

9.2 DATE STAMPING OF FILES 

9.2.1 Each entry in the directory occupies 32 bytes. Only the 
first 16 are used by the DOS, leaving the rest available for other 
uses. This space is ideal for storing file attributes such as the 
creation date,or time. It is used by I1IWRITKR for storing print 
attributes of files, such as margin and paragraph indentation. 

9.2.2 The date stamping of files can be readily implemented by 
arranging the PEACH's date to be placed in the last 6 bytes of the 
directory entry whenever a file name is placed in the directory. A 
modification to the FILES code is then required to display the date 
beside each file name. A program to implement this modification has 
been included in APPENDIX III, and fits at the end of the DOS. 

9.3 MULTIPLE-COLUMN DIRECTORY LISTING 

9.3.1 An annoying feature of the DOS is that the FILES command 
displays in only one column, and very quickly scrolls off the screen. 
While the scrolling can be stopped be using CONTROL/S, the files 
already scrolled off can only be redisplayed by a new FILES command. 
The situation is not too hard to live with, with SD DOS, but with DD 
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discs holding many more files, the inconvenience is increased. The 
display can be improved by having the directory displayecj in more than 
one column, making use of all of the screen, instead of only the left 
hand side. 

9.3.2 When the FILES code has displayed one file name and its 
attributes, it displays a CRLF by a JSR $B0BE at $90E6. This call can 
be changed to a JMP to a program that shifts the current character 
position, not to the start of the next line, but to further along the 
same line. Only when the end of the line is reached is a new line 
taken. In this way, the standard directory can be displayed in 4 
columns (80 character mode), or 2 columns (40 character mode). 

9.3.3 If the DATE modification is implemented, each file name 
listed will take up 7 more bytes. Hence only 2 columns can be 
displayed in 80 character mode, and 1 column in 40 character mode. The 
program listed in APPENDIX III incorporates the DATE extension, and 
resides in the unused area at the end of the DOS. 

9.4 RUNNING A PROGRAM ON BOOT UP 

9.4.1 When the DOS initializes itself, it displays its sign-on 
message, then jumps to the same code (at $FD42 ) that the cassette 
system uses to display the number of free bytes. This jump can be 
redirected to code that will perform other functions, such as running 
a startup file, or loading extended commands. 

9.4.2 Now the ROM code at $E6C5 loads the file name defined in 
$lFE-$205, (with $1FD being the number of characters in the file 
name), into memory and executes it. After initialization, the file 
name is NULL, i.e. it is filled with spaces, and $1FD“0. Hence a jump 
to $E6C5 after initialization will cause the NULL file to be run. This 
must be a BASIC file, but there are no restrictions in its use. The 
program in APPENDIX III incorporates this boot up procedure. 

9.4.3 This procedure for running the NULL file seems to have 
something lacking as sometimes the screen controller chip is not set 
up properly. Some graphics programs will run with a funny screen mode. 
However, by holding down the BREAK key, the NULL file will load, but 
not run. The BREAK procedure resets everything correctly, so the 
program having difficulty may now be loaded and run properly. 

9.4.4 If the DATE extension is used, it is a good idea to write a 
boot-up program to ask for the date to be entered from the keyboard, 
as in the following listing. 

10 INPUT "Enter the date in the form (83 /08/2 6)";A $ 

20 IF A $ ■ " " THEN DATE $-"83 /08/2 6" ELSE DATE $“A $ 

30 FILES 
40 END 

9.4.3 If the disc is to be used for games, the boot up file could 
be a menu of games to be selected by letter or number. 
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9.5 CHAIN1NG PROGRAMS 

9.5.1 When a program is loaded into RAM and executed, the ROM 
Load-and-run system effectively performs a NEW command, thus clearing 
out any program that was in memory before the load. It is not possible 
to define variables in one program and use them in another program, 
without storing them first in a data file on disc. This process of 
loading in programs one after the other, and passing variables between 
them is called CHAINing. 

9.5.2 A means of Implementing chaining would be to move a 
program s symbol table to the top of RAM, load in the next program, 
then move the symbol table back down to just above the new program, 
its usual position. All the variables defined by the previous program 
would then be available to the program just loaded. 

9.5.3 This technique would require the LOAD command to be 
executed. This code is in ROM and returns to BASIC after completion. A 
return to a machine code program could be performed as explained in 
the notes for the OPEN command (section 4.1). 

9.6 WILD CARD OPTIONS 

9.6.1 It is sometimes desirable to perform a function several 
times on a number of different files. For example, display directory 
files that begin with FOX, or delete all files that have the extension 
TMP. By use of the wild card feature, a "don't care" character would 
be considered a match. In the following examples, the '*' is the wild 
card character. 

FILES "1:F0X*.*" List all files beginning with FOX.. 

KILL "1;*.TMP" Delete all files with the extension TMP 

9.6.2 This wild card feature could be coupled with a user query, 
so that each file name found to match would be displayed, along with a 
'yes or no?' question.As you can imagine, enthusiastic use of the wild 
card could have disastrous effects, so a query acts as a second chance 
to detect mistakes. 

9.6.3 The wild card capability comes under the category of nice, 
but not necessary. However, if extended commands are implemented as 
discussed below, the incorporation of a wild card feature would be 
feasible. 

9.7 NEW COMMANDS 

9.7.1 The PEACH ROM NOTES' gives a good account of how new 
commands can be added to the SD DOS. By following the Instructions 
explained there, and with reference to the DD DOS commands discussed 
in these notes (section 7), new commands can be added to the DD DOS in 
a similar manner. 

9.7.2 It would seem logical to put new commands In RAM just below 
the DOS, after the DOS has been initialized. The boot-up file could do 
this. Several BASIC pointers would need to be adjusted to point to the 
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new top of memory, the new end of string space, and the new stack 
region. # 

9.7.3 The pointers to be adjusted are:- 
top of memory $31)8, $2D 

end of string space $25, stack on return to BASIC 

9.7. A The space taken up by the new commands will eat into the 
user RAM, and some large programs such as STARTREK ADVENTURE will not 
fit into memory. If the NULL file is used to load the new commands, 
the user could be given the option to load them, or not. 

9.8 DISC BASED COMMANDS 

9.8.1 New commands added to the DOS will reduce the space 
available for programs, and could be quite a nuisance. If DOS commands 
could be stored on disc and only read into RAM when required, the 
space problem would be solved. It would be necessary to save the 
contents of the memory that the loaded command will occupy, and 
restore it when the command had finished its job. In this way, there 
is no limit to the sophistication of the new command, caused by lack 
of space. 

9.8.2 The time to load the new command would need to be 
considered, particularly when DOS commands are always immediately 
available. Long routines would take a long time to load, and just as 
long to save RAM and restore it. Hence there is still pressure on the 
programmer to write compact code. 

9.8.3 The question naturally arises as to where the command code 
would be stored on the disc, and how it would be loaded. One mechanism 
for storing these commands would be to produce them as relocatable 
binary files with the extension 'COM', and have a general command 
routine that would look for a command in the directory and load it. 
These COM files would need to be at the top of the directory, so that 
they would be found quickly. New commands could be added simply by 
putting the command file in the directory, and the command name in the 
command name table, once the general facility had been implemented. 
The nonexistant (to the DOS) DD sectors 17-32 on track 0 could be used 
as the scratch area (max of Ak), for saving the RAM area to be used by 
the c oramand s. 

9.8. A Another means of storing the command code would be to have a 
table ( referenced by command number) that contains the track,sector 
where the command code is stored on disc. These command programs would 
not be accessable via the directory, but have their own area set aside 
for them. These commands could be put on track 0, sectors 17-32, as 
the DOS doesn't know they are there. Thus no storage space would be 
taken from normal file storage on the disc. This scheme would have the 
advantage of quicker loading than the COM files, but it would not be 
so easy to add new commands. The suggested track 0 area would soon be 
filled, so commands would begin to take up file storage space also. 
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9.8.5 Some code would be needed in the DOS to recognize the new 
commands and then load the appropriate code from disc. Hence some 
space would be taken from user RAM for this command processing. BUT, 
some of the DOS commands are candidates for residing on the disc, so 
the new command processing could go in the space vacated by these DOS 
commands. These commands include DSKINI, FILES, NAME, VERIFY, 
DEVICE,and KILL. All of these commands are normally used in direct 
mode, and can be considered more like utilities, than program 
commands. 

9.8.6 A considerable number of new commands come to mind, if the 
the space limitation were lifted. The following are a few suggestions, 
and I'm sure you could think of more. 

a) List the directory in alphabetical order. 

b) List only file names of the specified extension. 

c) Short list the directory w/o date, A columns on screen. 

d) Copy dev:filel to dev:file2 with query. 

e) Initialize a disc, and check for bad blocks. Put $FE 
in the FAT for the group in error. 

f) Kill dev .‘file with query. 

g) Remove REM's and spaces from a program. 

h) Copy the display to the printer. 

9.8.7 Because of the ease of implementing new commands, I tend to 
favour the COM files system for disc based commands, although the time 
to search for the command may be irritating. Directory searches could 
be restricted to (say) 2 sectors, i.e. the first 16 files in the 
directory to minimize directory search time. 

9.8.8 Disc based commands thus would need to be processed in the 
following way. 

a) Check that the token is valid. 

b) Return to the token processing code at $DA0D. 

c) Each command processing routine would get the command name 
from the command name table, and call the general command 
routine. 

d) The general routine would perform the following tasks. 

i) Write out, to a scratch area on disc, the RAM area to 
be used by the command. 

ii) Load the command into RAM and execute it. (When the 
command completes its task, control returns to the 
general routine) • 

iii) Read the scratch area on disc back into RAM, and 
return to BASIC. 

9.8.9 Two tables would also be needed as already explained for new 
commands in section 9.7.1. These would be the command names, and the 
command execution addresses. 
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10.0 FINAL THOUGHTS 

10.0. 1 1 hope these notes have given you a better understanding of 
the internal workings of the DD DOS. I have tried to give enough 
information so that you can carry on your own investigations from a 
standpoint of knowledge, without having to rely on guess work. 

10.0.2 I have also tried to give some ideas on how the DOS could 
be Improved, without actually doing it. Perhaps someone who reads 
these notes will be inspired to take up the challenge and implement 
some of the suggestions. Most of these ideas are not original, and 
have been seen on other computer systems before. There is always a 
great deal of satisfaction, however, in putting some new feature into 
the DOS, particularly when others find it useful. 

10.0.3 There is a danger in modifying the DOS that it becomes 
incompatible with standard DD DOS. THIS IS TO BE AVOIDED AT ALL COSTS. 
Any modified DOS should be able to read and write discs in standard 
form, otherwise CHAOS will result. 

10.0.4 The serious DOS programmer will need three primary tools to 
help him in his task. A disassembler, an assembler, and a sector 
read/write/modify utility.These are readily available and make life 
much more enjoyable. 

10.0.5 Well, I hope you have as much enjoyment in putting the DD 
DOS to good use, as I have had in producing* these notes. 
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*D0UB LE DENSITY ROM BOOTSTRAP 
*R EAD TRACK 0,SECTOR 1,2 IN SINGLE DENSITY 
* 

*D I S C REGISTERS 

* F F 00 R EAD =S TATUS, WRITE"COMMAND 

* FF01 CURRENT TRACK 

* F F 02 SECTOR 

* F F 03 DATA 

* F F 04 R EAD“DATA READY (MS BIT) 

* WRITE=BIT 0, 1 “DRIVE 

* BIT 3 “MOTOR ON 

* BIT 4 “SIDE 

* BIT 5 “D D =1, SD*0 

* BIT 6 -NMI MASK 

* 

ORG $FE7E 

* 


FE 7E 

12 

ZFE7E 

NO P 


ENTRY POINT 

FE7F 

1 2 


NOP 



F E 8 0 

1 2 


NOP 



F E 8 1 

CEFF00 

Z FEB 1 

LDU 

// $ F F 0 0 

POINT TO REGISTERS 

F E 84 

CC2F08 


L DD 

// $ 2 F 0 8 


F E 8 7 

A 7C4 


STA 

, u 

RESET CONTROLLER 

F E 8 9 

E 744 


STB 

4,U 

DRIVE 0,S D,SIDE 0 

FE8B 

4F 


CLRA 



FE8C 

5F 


CLRB 



FE 8D 

1F 0 1 


TFR 

D, X 

X»0 

FE8F 

8D 0A 

ZFE8F 

B SR 

Z FE9B 

RTS ONLY 

F E 9 1 

3 0 1 F 


LEAX 

-$01, X 


F E 93 

2 6FA 


BNE 

ZFE8F 

WAIT 16 BIT COUNT 

FE95 

6DC4 


TST 

,u 

LOOK AT STATUS 

FE 9 7 

2B 03 


BMI 

ZFE9C 

DRIVE PRESENT 

F E 9 9 

6 F 4 4 

ZFE99 

CLR 

$04 , U 

DRIVE NOT PRESENT 

FE9B 

39 

ZFE9B 

RTS 


RETURN TO CASS BASIC 


* 


*HERE AFTER CLEAR 
* 

FE9C 4C ZFE9C 

FE9D A5C4 ZFE9D 

FE9F 27FC 
FEA1 867E 
FEA3 B 70109 
FEA6 308D09 
FEA 9 BF010A 
FEAC 8 6 F E 
FEAE A 7C4 

FEB0 2 OF E Z FEB 0 

* 

*HERE AFTER RESTORE TO TRACK 0 
* 

Z FEB 2 LEAS $0C,S CLEAN UP STACK 

LDA ,U GET STATUS 

LDX // $ 4 4 0 0 LOAD BOOT BLOCK PROGRAM HERE 

Z FEB 9 INCB SECTOR 1 

PSHS X,B,A 


FEB 2 3 2 6C 
FEB4 A6C4 
FEB6 8 E 4 4 0 0 
FEU 9 5C 
FEBA 3416 


INCA 


( A ) “ 1 


BITA 

, u 

LOOK AT STATUS 

BEQ 

ZFE9D 

DRIVE BUSY 


LDA 

//$ 7E 

SET UP NMI 

VECTOR 

STA 

$0109 



LEAX 

Z FEB 2,PC R 

TO FEB2 


STX 

$0 10A 



LDA 

// $ F E 

RESTORE(01 

INVERTED) 

STA 

, u 



BRA 

Z FEB 0 

WAIT FOR INT 
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FEBC 

108E000A 


LDY 

0 $0 00A 

it TRIES ON ERROR 

FECO 

8E FEDC 

Z FEC 0 

LDX 

0 F E D C 

SET UP INT RETURN AFTER SECT 

F EC 3 

B F010A 


ST X 

$0 1 OA 


FEC 6 

E C E 4 


LDD 

.s 

PUT SECTOR IN fe 

F EC 8 

A F. 6 2 


LDX 

$02,X 

BUFFER ADR 

FEC A 

5 3 


COMB 



FKCB 

E 74 2 


STB 

$02,U 

SECTOR REGISTER 

FECI) 

86 7F 


L DA 

it$ 7F 

READ CMD (80 INVERTED) 

FEC F 

A 7C4 


STA 

.u 

OUTPUT TO CMD REGISTER 

F K D 1 

A 6 4 4 

Z FED 1 

L DA 

$04,U 

LOOK AT MS BIT OF DRIVE REG 

FED 3 

2 B FC 


BMI 

Z F E D 1 

NO CHARACTER AVAILABLE 

F ED 5 

E 643 


LDB 

$03 , U 

READ CHARACTER 

FED7 

53 


COMB 



FED8 

E 7 80 


STB 

, X + 

STORE IN 4400+ 

FEDA 

2 OF 5 

A 

BRA 

Z FED 1 

READ NEXT 



* H E R E 

AFTER 

READ OF 

SECTOR 

FEDC 

8608 

Z FEDC 

LDA 

it $0 8 


FEDE 

A 74 4 


STA 

$04,U 

DRIVE 0 , SD , S IDE 0,BIT 7*=1 

F EE 0 

3 2 6C 


LEAS 

$0C , S 


F EE 2 

A6C4 


LDA 

,u 

GET STATUS 

FEF.4 

43 


COMA 



FEE5 

5F 


CLRB 



FEE6 

85DC 


BITA 

f?$DC 

REMOVE UNWANTED BITS 

FEE8 

2 70 5 


BEQ 

Z FEEF 

GOOD READ 

FEEA 

3 I 3 F 


• LEAY 

>* 

o 

</> 

i 

ERROR COUNT 

F E EC 

2 6D2 


BNE 

ZFECO 

TRY AGAIN 

FEEE 

43 


COMA 



FEEF 

3 52 6 

Z FEEF 

PULS 

Y,B, A 


FEF 1 

2 5A5 


BCS 

ZFE99 

BAD READ, ABORT DISC 

FEF3 

C 102 


CMPB 

it $0 2 


FEF 5 

2 5C2 


BCS 

Z FEB 9 

READ SECOND SECTOR 

FEF 7 

E 6 1 F 


LDB 

-$01, X 

LOOK AT LAST CHAR READ IN 

FEF9 

C 1DD 


CMPB 

// $D D 


FEFB 

2 69B 


BNE 

Z FE99 

BAD, SHOULD BE DD 

FEFD 

7E4400 


JMP 

$4400 

NOW RUN BOOT BLOCK PROGRAM 
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*5 INCH DD BOOT BLOCK 

* FOR HITACHI PEACH 

* RESIDES ON TRACK 0,SECTOR 1 AND 2 OF DISC 

* 

* N 0 T E: DATA TO/FROM DISC REGISTERS IS INVERTED 

A 

^COMMENTS BY PETER CALDER,14 SANDY CRES, 

* SALISBURY PARK,S. AUST 

A 

*83 /04/26 

A 

*1/0 REGISTERS 

* FFOO STATUS (READ ) ,COMMAND (WRITE) 

* FF01 CURRENT TRACK 

* FF 02 REQD SECTOR 


* Fr UJ DATA REG 

* FF04 DRIVE REG 

A 

A 


4400 


ic 

ORG 

$4400 

4400 

7E440B 

Z 4 4 00 

JMP 

Z 440B 

4403 

00 

Z 4 4 03 

FCB 

$00 

4404 

20 

Z 4 4 04 

FCB 

$20 

4405 

8800 

Z 4 4 0 5 

FDB 

$8800 

4407 

9FFF 

Z 4 4 0 7 

FDB 

$9FFF 

4409 

FF 

Z 4 4 0 9 

FCB 

$FF 

44 OA 

06 

Z 44 0A 
* 

FCB 

$06 

4 4 OB 

8603 

Z440B 

LDA 

it $0 3 

4 4 OD 

B 7FFC4 


STA 

$F FC 4 

4410 

10CE45FF 


LDS 

//$4 5FF 

44 14 

1 08EFF00 


LDY 

// $ F F 0 0 

44 18 

BE4405 


LDX 

Z 4 4 0 5 

44 IB 

8606 

Z 4 4 1B 

LDA 

it $0 6 

44 ID 

B 74 4 0A 


STA 

Z 44 0A 

44 2 0 

3410 


PSHS 

X 

4422 

7C4404 


INC 

Z 4 4 04 

442 5 

F 64 4 04 


LDB 

Z 4404 

442 8 

C 1 20 


CMPB 

//$ 20 

4 4 2A 

23 2 3 


BLS 

Z 4 44F 

44 2C 

7C44 03 


INC 

Z 4 4 03 

4 4 2 F 

860 1 


LDA 

it$0 1 

443 1 

B 74 4 04 


STA 

Z 4 4 04 

443 4 

C E 4 4 4 6 

Z 4 4 3 4 

LOU 

0Z 444 6 

443 7 

FF 01OA 


STU 

$0 1 OA 

4 4 3 A 

B 64403 


LDA 

Z 4403 

4 4 3 D 

43 


COMA 


4 4 3 E 

A 72 3 


STA 

$03, Y 

44 4 0 

C 6EE 


LDB 

// $E E 

4442 

E 7A 4 


STB 

. Y 

4444 

2 OF E 

Z 4444 

BRA 

Z 4444 


A 


*H ERE AFTER SEEK TRK 

A 


DATA READY(7), SD/DD(5), SIDE(4) 
MOTOR ON(3 ),DRIVE (0-1 ) 


ENTRY POINT 

TRK //-START LOADING TRK 1 
SECTOR // 

DOS LOADS FROM HERE 
TO HERE 

CURRENT DRV REG VALUE 
it TRIES ON ERROR 


RESET ACIA 

INPUT BUFFER*4600+ 

I /O REGS (FF00-FF04) 
PROGRAM LOAD ADR 

6 TRIES ON ERROR 
X USED FOR LOADING INTO 
SECTOR it 

END OF TRK? 

NO,READ NEXT SECTOR 
YES, INC TRK it 

INITIALIZE TO SECTOR 1 
SET UP I NT RET ADR 

TRK it 

IN FF03,DATA REG 
COMD 11,SEEK TRK 
IN FFOO,CMD REG 
WAIT FOR INT 

INTERRUPT 
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4 44 6 

3 2 6C 

Z 4 4 4 6 

LEAS 

$0C,S 

CLEAN UP STACK 

444 8 

A 6A4 


L DA 

. Y 

LOOK AT STATUS 

4 4 4 A 

43 


COMA 


t 

4 4 4 B 

84 80 


ANDA 

l $ 80 


4 4 4D 

2 65 5 


BNE 

Z 4 4 A 4 

DRIVE NOT READY,ABORT 

4 4 4 F 

B 64 4 03 

Z444F 

LDA 

Z 4 4 03 

TRK 0 

4 4 52 

43 


COMA 



44 53 

A 72 1 


STA 

$01, Y 

IN FF01,CURRENT TRK REG 

44 5 5 

862 8 


LDA 

//$ 2 8 

BITS-DD,MOTOR ON,DRIVE 0 

4 4 5 7 

F 64 4 04 


LDB 

Z 4 4 04 

SECTOR 0 

44 5A 

C110 


CMPB 

// $ 1 0 

>16? 

4 4 5C 

2 3 04 


BLS 

Z 44 62 

NO 

4 4 5E 

8A 10 


ORA 

0$IO 

YES,SET SIDE BIT 

44 60 

C010 


SUBB 

0$1O 


44 62 

A 724 

Z 44 62 

STA 

$04 , Y 

IN F F 04, DRV REG 

4 4 64 

B 1 4409 


CM PA 

Z 4 4 0 9 

IS MOTOR ALREADY ON? 

44 6 7 

2 7OB 


BEQ 

Z 4 4 74 

YES 

4 4 69 

3410 


PSHS 

X 

NO,WAIT FOR MOTOR 

44 6B 

8E 1 73 E 


LDX 

0$ 1 73 E 


4 4 6E 

3 0 l F 

Z446E 

LEAX 

-$01,X 

COUNT BACK TO 0 

44 70 

26FC 


BNE 

Z 446E 


44 72 

3510 


PULS 

X 


44 74 

53 

Z 44 74 

COMB 



44 75 

E 722 


STB 

$02, Y 

IN FF02,SECTOR REG 

44 7 7 

CE4 4 8C 


LDU 

0 Z44 8C 

SET UP INT RET ADR 

4 4 7A 

F F 0 1 OA 


STU 

$0 1 OA 


44 7D 

C 6 7F 


LDB 

0$7F 

COMD $80,READ SINGLE SECTOR 

44 7F 

E 7A4 

A 

STB 

, Y 

IN F F 00,COMD REG 



*R EAD 

A 

DATA UNTIL END-OF 

-SECTOR INTERRUPT 

44 81 

A 62 4 

Z 4 4 81 

LDA 

$04, Y 

LOOK AT DATA READY BIT,FF04 

44 83 

2B FC 


BMI 

Z 4 4 81 

DATA NOT READY 

44 85 

E 62 3 


LDB 

$03, Y 

FROM FF03,DATA REG 

44 87 

53 


COMB 


DATA INVERTED 

44 88 

E 7 80 


STB 

, X+ 

STORE DATA IN MEM 

4 4 8A 

2 OF 5 

A 

BRA 

Z 4 4 81 

UNTIL INT AT END OF SECT 



*H ER E 

AFTER 

SECTOR READ 

IN 

4 4 8C 

3 2 6C 

Z448C 

LEAS 

$0C , S 

CLEAN UP STACK 

44 8E 

A 6A 4 


LDA 

, Y 

LOOK AT STATUS,FFOO 

44 90 

43 


COMA 



449 1 

84 9C 


ANDA 

0 $9C 


4493 

2 6 1 C 


BNE 

Z 4 4 B 1 

BAD READ 

44 95 

3 540 


PULS 

U 


44 9 7 

BC4407 


CMPX 

Z 4 4 0 7 

END OF LOADING REGION? 

4 4 9A 

1023FF7D 


LBLS 

Z44 IB 

NO,READ NEXT SECTOR 

44 9E 

6F24 


CLR 

$04, Y 

YES,CLEAR DRV REG,FF04 

4 4a 0 

6E9F4405 

A 

JMP 

f Z 4 4 0 5 ] 

START DOS 



*11 ER E 

IF DISC NOT READY 

AFTER SEEK 



*OR TOO MANY 
* 

ERRORS 


4 4 A 4 

6F24 

Z44A4 

CLR 

$04 , Y 

CLEAR DRV REG,FF04 

4 4 A 6 

C 63 9 


LDB 

0 $3 9 

PUT RTS INSTRUCTION 
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4 4 A 8 

F 70 1 09 


STB 

$0109 

IN NMI VECTOR ADR 

4 4 A B 

1 ODE 2 5 


LDS 

$002 5 

USE CAS BAS STACK 

4 4A E 

7EFB61 

A 

JMP 

$ F B 6 1 

START CAS BASIC 



*11 ER E 

A 

IF BAD READ 


44B 1 

86 2 F 

Z 4 4B 1 

LDA 

0 $ 2 F 

CM D 1)0,CLEAR 

4 4 B 3 

A 7A4 


STA 

, Y 

IN FFOO,COMD REG 

4 4 B 5 

8D IB 


B SR 

Z44D2 

WAIT UNTIL NOT BUSY 

4 411 7 

CE44C3 


LDU 

0 Z44C3 

SET UP INT RET ADR 

4 411A 

FF010A 


STU 

$0 1 OA 


4 411 D 

8 6 F E 


LDA 

0 $FE 

CMD 01,RESTOKE 

4 4 B F 

A7A4 


STA 

, Y 

IN FFOO,COMD REG 

44C 1 

2 OF E 

Z44C 1 

A 

BRA 

Z44C 1 

WAIT FOR INT 



*11 ER E 

A 

AFTER 

RESTORE 

INTERRUPT 

44C3 

3 2 6C 

Z44C3 

LEAS 

$0C , S 

CLEAN UP STACK 

44C 5 

8D OB 


B SR 

Z 44D 2 

WAIT UNTIL NOT BUSY 

4 4C 7 

A 6E 4 


LDA 

,s 


44C9 

7 A 4 4 OA 


DEC 

Z44 0A 

0 TRIES ON ERROR 

44CC 

102 6FF64 


LB NE 

Z 443 4 

TRY TO READ SECTOR AGAIN 

44D0 

2 0D2 


BRA 

Z 44A4 

TOO MANY ERRORS,ABORT 


* 


*W A IT FOR NOT BUSY 
*OR TIMEOUT 

*NOTE: STATUS IS INVERTED 


44D2 

C E0000 

Z44D2 

LDU 

050000 



44D 5 

860 1 

Z44D 5 

LDA 

$01 

SET BIT 

1 

4 4 D 7 

A 5A 4 


BITA 

, Y 

LOOK AT 

STATUS,FFOO 

44D 9 

2 604 


BNE 

Z 44DF 

WAIT FOR 

NOT BUSY 

44DB 

33 5F 


LEAU 

-$01 , U 

COUNT UP 

TO 0 

4 4DD 

26F6 


BNE 

Z44D5 



44DF 

39 

Z 44DF 

A 

RTS 


NOT BUSY 

OR TIMEOUT 

4 4 F F 


A 

ORG 

$4 4 F F 



4 4 F F 

DD 

A 

FCB 

$DD 

ROM BOOT 

LOOKS FOR DD HERE 

4400 



END 

$44 00 
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* DSDD DOS MODIFICATIONS * 

* 

* 1.DISPLAY DATE IN DIRECTORY LISTING # 

* 2.INSERT DATE IN DIR WHEN FILE CREATED 

* 3.RUN NULL FILE ON BOOT UP 

* 

* WRITTEN BY PETER CALDER 

* . 14 SANDY CRESENT,SALISBURY PARK,S.AUST,5109 

* JAN 83 

* RUN NULL FILE OBTAINED FROM BRUCE ROSSELL,CANBERRA 


8 A 9 1 

* 

ORC 

$ 8A 9 1 


8A9I 7E9FCE 

a 

JMP 

RNUL 

RUN NULL FILE 

9 0 E 6 


ORG 

$90E 6 


9OE 6 BD9F6C 


JSR 

DATE 

DATE DISPLAY 

94 5B 


ORG 

$94 5B 


94 5B. BD9FBD 

it 

JSR 

INSDT 

INSERT TIME/DATE 

9 F 6C 

* 

ORG 

$ 9 F 6C 



* 

DISPLAY 

DATE 





* REQUIRES 

* 

JSR DATE AT 

90E6 

9F6C 

343 6 

DATE 

PSHS 

A,B,X,Y 


9F6E 

B 602 3 8 


L DA 

$238 

ALLOW FOR 2 DIGIT GROUP 

9F 7 1 

8113 


CM PA 

// $ 1 3 


9F 73 

2 704 


B EQ 

D 1 


9F 75 

81 3B 


CM PA 

// $3 B 


9F 77 

2 601 


BNE 

D 2 


9F 79 

4 C 

D 1 

INCA 


SPACE 

9F 7A 

4C 

D 2 

INCA 



9F 7B 

B 70238 


STA 

$238 


9 F 7E 

B 60 1 1 6 


LDA 

$116 


9F 8 1 

A 7E2 


STA 

, -s 

SAVE COLOUR 

9F83 

8606 


LDA 

0$6 


9F85 

B 701 16 

it 

STA 

$1 16 

DATE IN YELLOW 

9 F 8 8 

A E 6 9 


LDX 

$9, S 

POINT TO DIR ENTRY ADR 

9F 8A 

3 0 8 8 1 A 


LEAX 

$ 1A , X 

POINT TO DATE AREA 

9F 8D 

8D2 5 


BSR 

OUT 2 

YEAR 

9F 8F 

8D IF 


B SR 

OUS EP 

MONTH 

9 F 9 1 

8D ID 


BSR 

OUSEP 

DAY 

9F93 

A 6E0 


LDA 

»s + 


9F95 

B 70 l 1 6 

if 

STA 

$116 

RESTORE COLOUR 

9F 98 

B 602 38 

COL40 

LDA 

$238 

<40? 

9F9B 

8128 


CM PA 

11 $2 Q 


9F 9D 

2 4 OB 


BUS 

COLO 

NO,START NEW LINE 

9F9F 

8628 


LDA 

0$ 2 8 


9FA 1 

9 1A 2 


CM PA 

$A2 

40 COLUMN MODE? 

9FA3 

2 70 5 


B EQ 

COLO 

YES 

9F A 5 

B 702 38 


STA 

$0238 

NO, SET TO COL 40 
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9F A 8 

2 003 

A 

BRA 

RETN 


9FAA 

BOB0BE 

COLO 

JSR 

$B OB E 

PRINT CR 

9FAD 

3 53 6 

RETN 

PULS 

A, B , X, Y 


9FAF 

39 

* 

RTS 



9FB0 

8 6 2 F 

OUSEP 

LDA 

0$2F 

'/' 

9FB 2 

8D 06 


B SR 

OUT 

DISPLAY SEPARATOR 

9FB4 

8D 00 

0 UT 2 

BSR 

0 UTC 

DISPLAY 1st CHAR, THEN 2nd 

9FB6 

A 6 80 

0 UTC 

LDA 

, X + 

GET CHAR 

9FB8 

8B30 


ADDA 

0 $3 0 

ADD ASCII BASE 

9 F B A 

7EE820 

OUT 

A 

JMP 

$E 82 0 

DISPLAY CHAR 



*IN S E R T DATE IN DIR 




* REQUIRES 

A 

JSR AT $ 94 5B 


9FBD 

3454 

INSDT 

PSHS 

U, X, B 


9FBF 

3 3 4 F 


LEAU 

$F, U 

POINT TO TIME IN DIR ENTRY 

9FC l 

8E021C 


LDX 

tf$2 1C 

POINT TO TIME IN MEM 

9FC4 

C 60 6 


LDB 

0$O6 


9FC6 

BDFC4 8 


JSR 

$ F C 4 8 

MOVE TIME/DATE 

9FC9 

3 554 


PULS 

U,X,B 


9FCB 

7E 9D 6B 

it 

JMP 

$9D 6B 

NOW WRITE SECTOR 



* RUN 

NULL 

FILE * 




* REQUIRES 

A 

JMP AT 8A91 

AFTER INITIALIZATION 

9FCE 

DC 2 5 

RNUL 

LDD 

$25 

LOW END OF STRING SPACE 

9FD 0 

93 ID 


SUBD 

$ 1 D 

START OF PROGRAM SPACE 

9FD 2 

BDC 682 


JSR 

$C 6 82 

DISPLAY DIGITS 

9FD5 

8EFD9A 


LDX 

// $ F D 9A 

"bytes free" 

9 FD 8 

BDB 1 04 


JSR 

$B 104 

DISPLAY TEXT 

9FDB 

1CAF 


ANDCC 

</> 

> 


9FDD 

7EE6C 5 

A 

JMP 

$E6C5 

EXECUTE NULL FILE 




END 
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